阿里云领取￥2000红包，服务器低至￥91.80/年
JooLun版本
- V2.7.0+
请严格按照教程操作；不要自己改库名、改包名、改服务端口，教程上没有说的就不要动，这样出了问题我们才好给你排查，等你熟悉项目了再改也不迟；因自己改了教程之外的东西出了问题来咨询技术的，我们都不受理
开发环境准备（注意版本）
- windows系统（确保你的电脑内存充足，16G起步）
- IntelliJ IDEA（一定要安装lombok插件） + WebStorm + 微信开发者工具
- MySql8（MySql版本至少5.7或者5.7+，强烈推荐mysql8，建议安装在本机或同一局域网，否则可能会因为网络问题引起超时）
- Redis（建议安装在本机或同一局域网，否则可能会因为网络问题引起超时）
- JDK8
- maven v3.6.0（后端项目构建管理）
- node v16..（前端构建管理）
- npm v7..
- SwitchHosts（用于修改hosts）
- 阿里OSS、七牛云、minio、腾讯cos 四选一
- 申请好小程序一个（我们演示小程序的类目是：商家自营 > 家电/数码/手机）
- 申请好微信支付商户一个
- 快递100key一个
- 必须保证机器的外部网络是通的
了解项目结构
下载源码
项目导入
- 直接从git私服页面上下载源码，分别将joolun项目导入到idea，joolun-ui项目导入到webstorm，joolun-ma项目（小程序版特有）导入到微信开发者工具
修改hosts
-
以管理员的身份运行SwitchHosts!，添加如下配置（假如你的mysql没在本机，把127.0.0.1换成实际ip就行了）
-
hosts修改方法有多种，推荐使用SwitchHosts!工具，其他方法请自行百度
-
❗特别说明：请一定要按此步骤配置hosts，禁止修改代码中配置成IP或localhost
-
hosts配置完成后，逐个ping base-xx 确认可以使用!
# 本地开发环境 127.0.0.1 base-nacos 127.0.0.1 base-gateway 127.0.0.1 base-redis 127.0.0.1 base-mysql
-
再用数据库工具直接连base-mysql，看能否连接上MySQL，确保hosts成功修改
导入数据库（joolun/db）再次重申mysql版本必须在5.7或以上，最好是mysql8，不然系统无法运行
- 依次将db目录下的.sql脚本导入到mysql（3个库都要导入），商城版还有一个base_mall.sql也要导入，【升级脚本】不用管，版本升级时才有用
- 注意：mysql5.7脚本导入报“Unknown collation: 'utf8mb4_0900_ai_ci'“错，请把脚本中的所有”utf8mb4_0900_ai_ci”换成“utf8mb4_bin”，当然你也可以把mysql版本升到8.0.1以上，毕竟8的在性能方面提升很大
后端发布
-
idea打开（直接open）后端代码（joolun）-->配置maven-->等待maven下载完相应的jar包-->再安装lombok插件
-
修改nacos配置文件中的数据库账号密码（joolun/server/nacos-server/conf/application.properties）
-
双击（joolun/server/nacos-server/bin/startup.cmd）启动nacos，nacos要一直运行不要关了（Mac或其他系统请查看nacos官网，要单机模式启动）；nacos包我们直接在官方下载的，没有做任何二开，如启动不了肯定就是你系统环境问题，请自行解决
-
nacos启动成功后，浏览器中打开http://base-nacos:8848/nacos/index.html 账号密码：nacos/nacos
-
nacos控制台中修改相关密码
application-dev.yml：修改redis密码base-auth-dev.yml、base-codegen-dev.yml、base-upms-admin-dev.yml、base-weixin-admin-dev.yml、base-mall-admin-dev.yml：修改mysql账号、密码，将root换成自己的账号密码
注意冒号后面要带一个空格，redis和mysql的密码不要用纯数字，否则无法启动
-
然后idea依次启动
JooLunGateWayApplication（网关） JooLunAuthApplication（认证授权） JooLunUpmsApplication（后台管理模块） JooLunWeiXinApplication（微信管理模块） JooLunCodeGenApplication（代码生成模块） JooLunMallApplication（商城管理模块）注意每个服务是否有报错，一定要按顺序启动（nacos -> base-gateway -> base-auth -> base-upms -> base-weixin -> base-mall），启动下一个服务时一定要保证上一个服务没有报错
-
商城版需要将redis的key过期推送功能打开，否则订单无法自动取消（自行百度redis的key过期推送怎么打开）
-
后台【文件存储配置】配置存储服务，不配无法上传图片，详情查看文档【文件存储功能】
前端发布
-
特别说明：请不要自己随意升级package.json里的sdk版本，特别是avue版本，很可能会引起很多问题
-
确认已经安装好了node和npm
-
WebStorm打开（直接open）前端代码（joolun-ui）
-
在joolun-ui目录下运用如下命令
npm install --registry=https://registry.npmmirror.com
-
install完成后，再运用
npm run serve，如下图
-
访问地址：localhost:8082 管理员账号密码：admin/123456
小程序端调试
-
后台【小程序管理】中增加自己的小程序账号
注：微信支付商户号请自行申请，如果不填或乱填将无法下单
小程序申请地址：https://mp.weixin.qq.com/
微信支付申请地址：https://pay.weixin.qq.com/index.php/core/home/login?return_url=%2F
-
微信支付平台账号关联（小程序AppID绑定）
-
将小程序（joolun-ma）代码，导入到微信开发者工具
-
修改配置文件（joolun-ma/config/env.js）中的服务器地址。本地调试开发服务器地址配http://localhost:8082 即可，basePath其实就是后台访问地址，如果要用手机预览要把localhost换成局域网ip，手机和电脑要处于同一局域网中，手机上要打开调试，详情请参考本地手机预览；正式环境一定要域名https协议，不然小程序无法发布
-
微信开发者工具打开不校验合法域名（是勾选上）
-
个人小程序或没有直播功能的小程序运行时会报“插件未授权使用”，删除直播插件即可
-
编译后即可在开发者工具中开发调试小程序代码了
-
修改回调地址等相关配置（nacos中的base-mall-admin-dev.yml），修改后要重启base-mall服务才能生效
回调地址可以直接设为网关（默认端口9999）地址，也可以是后台的访问地址（默认端口8082），ip、域名均可
注：回调地址要外网能访问，不然收不到支付结果、退款结果、物流信息等，快递100的授权码自行申请
后台服务不在本机
- 在实际开放过程中，前后端可能会由不同的人开发，所以后台服务（joolun）可能不在本地，而是运行在其他同事电脑上。所以需要改下接口访问地址
- 后端页面：修改
joolun-ui/vue.config.js中的url；直接是网关服务（默认：ip:9999）的访问地址 - 小程序端：修改
joolun-ma/config/env.js中的basePath；可以是后台（joolun-ui）访问地址，也可以直接是网关服务（默认：ip:9999）的访问地址